home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / system.0 < prev    next >
Text File  |  1996-09-02  |  1KB  |  35 lines
  1.  
  2. SYSTEM(3)                  UNIX Programmer's Manual                  SYSTEM(3)
  3.  
  4. NNAAMMEE
  5.      ssyysstteemm - pass a command to the shell
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddlliibb..hh>>
  9.  
  10.      _i_n_t
  11.      ssyysstteemm(_c_o_n_s_t _c_h_a_r _*_s_t_r_i_n_g)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The ssyysstteemm() function hands the argument _s_t_r_i_n_g to the command inter-
  15.      preter sh(1).  The calling process waits for the shell to finish execut-
  16.      ing the command, ignoring SIGINT and SIGQUIT, and blocking SIGCHLD.
  17.  
  18.      If _s_t_r_i_n_g is a NULL pointer, ssyysstteemm() will return non-zero.  Otherwise,
  19.      ssyysstteemm() returns the termination status of the shell in the format speci-
  20.      fied by waitpid(3).
  21.  
  22. RREETTUURRNN VVAALLUUEESS
  23.      If a child process cannot be created, or the termination status of the
  24.      shell cannot be obtained, ssyysstteemm() returns -1 and sets _e_r_r_n_o to indicate
  25.      the error.  If execution of the shell fails, ssyysstteemm() returns the termi-
  26.      nation status for a program that terminates with a call of eexxiitt(_1_2_7).
  27.  
  28. SSEEEE AALLSSOO
  29.      sh(1),  execve(2),  popen(3),  waitpid(3),
  30.  
  31. SSTTAANNDDAARRDDSS
  32.      The ssyysstteemm() function conforms to ANSI C3.159-1989 (``ANSI C'') and .
  33.  
  34. BSD Experimental                 June 29, 1991                               1
  35.